Skip to content

feat: add Hydrex Base MCP plugin#90

Closed
CottonEyeBro wants to merge 5 commits into
base:masterfrom
hydrexfi:master
Closed

feat: add Hydrex Base MCP plugin#90
CottonEyeBro wants to merge 5 commits into
base:masterfrom
hydrexfi:master

Conversation

@CottonEyeBro

@CottonEyeBro CottonEyeBro commented Jun 10, 2026 •
edited
Loading

Copy link
Copy Markdown

Summary

This PR adds a plugin for Hydrex, an Omni-Liquidity MetaDEX on Base that delivers the best swap rates on Base and supports concentrated liquidity position management.

What This Adds

skills/base-mcp/plugins/hydrex.md — a complete send_calls-based plugin covering:

  • DEX swaps with best available routing on Base
  • Concentrated liquidity position management — open and close positions
  • Read endpoints for live quotes, wallet portfolio, open positions, and trade history
  • Full orchestration patterns for harness surfaces (Claude Code, Cursor, Codex) and chat-only surfaces (Claude.ai, ChatGPT)
  • Price impact guard — warns the user and requires explicit confirmation before executing any swap with price impact > 5%
  • Slippage defaults (50 bps) with user-overridable parameters on all write operations

Infrastructure

The plugin is backed by a dedicated prepare server hosted at https://hydrex-agent.com, built on the hydrex-base-mcp Express server running against Base mainnet (chainId: 8453).

Allowlist Request

Please add hydrex-agent.com to the web_request allowlist so the plugin works natively on Claude.ai and ChatGPT consumer surfaces. On harness surfaces the plugin works today via direct HTTP tool calls without allowlisting.

Endpoints

Endpoint Type Description
GET /health Read Server health check
GET /state/quote Read Best available swap quote on Base
GET /state/portfolio Read Token balances and LP positions for a wallet
GET /state/positions Read Open concentrated liquidity positions
GET /state/trade-history Read Past swaps executed through Hydrex
GET /prepare/swap Prepare Returns unsigned swap calldata
GET /prepare/add-liquidity Prepare Returns unsigned approve + mint calldata
GET /prepare/remove-liquidity Prepare Returns unsigned remove-liquidity calldata

All prepare endpoints return a transactions[] array ready to pass directly to send_calls.

Testing

Health check:

GET https://hydrex-agent.com/health

{"ok":true,"service":"hydrex-base-skill-server","chainId":8453}

Sample quote — 10 USDC → WETH:

GET https://hydrex-agent.com/state/quote?tokenIn=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokenOut=0x4200000000000000000000000000000000000006&amount=10000000&recipient=0x0000000000000000000000000000000000000001

CottonEyeBro and others added 5 commits June 3, 2026 13:46
@CottonEyeBro
copy over hydrex.md skill file from separate skill repo + update SKIL…
1a18829 
…L.md to include new hydrex plugin
@CottonEyeBro
chore: update routing from localhost to current VPS
9d25708
@CottonEyeBro @cursoragent
chore: migrate Hydrex plugin endpoint to https://hydrex-agent.com
dcb9077 
- Replace all http://hydrex-agent.com:3000 references with https://hydrex-agent.com
- Update allowlist from [] to [hydrex-agent.com] to request web_request allowlisting

Co-authored-by: Cursor <cursoragent@cursor.com>
@CottonEyeBro
init: staging branch
74079b5
@CottonEyeBro
Merge pull request #1 from hydrexfi/staging
66c2d6e 
feat: add Hydrex Base MCP plugin
@cb-heimdall

cb-heimdall commented Jun 10, 2026 •
edited
Loading

Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

youssefea
youssefea reviewed Jun 15, 2026
View reviewed changes
Comment thread skills/base-mcp/plugins/hydrex.md

---

### GET /prepare/add-liquidity

@youssefea youssefea Jun 11, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

how does the agent get the pool's contract address?

Comment thread skills/base-mcp/plugins/hydrex.md

```
1. get_wallets → address
2. GET /state/positions?address=<address> → show existing positions for context

@youssefea youssefea Jun 11, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what is the user doesn't have a position?

Comment thread skills/base-mcp/SKILL.md

@youssefea youssefea Jun 11, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove from SKILL.md, we'll add it later

@youssefea

youssefea commented Jun 17, 2026 •
edited
Loading

Copy link
Copy Markdown
Collaborator

Thanks again for putting this together, @CottonEyeBro. One operational note: this PR includes one or more commits that GitHub marks as unverified. We require verified commits for external plugin submissions so we can rely on GitHub signature and provenance checks before merging code into base/skills.

Could you please open a new PR with verified commits? I cannot merge this PR as-is. Thank you.

@CottonEyeBro

CottonEyeBro commented Jun 17, 2026

Copy link
Copy Markdown
Author

@youssefea thanks so much for the comments and feedback! Closing in favor of #106 , which re-submits this plugin from a clean branch with verified commits per the review note. All earlier feedback is addressed there — SKILL.md left untouched, pool discovery added via /state/pools, and empty-position handling for add/remove liquidity. Thanks again!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@youssefea youssefea youssefea left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@CottonEyeBro @cb-heimdall @youssefea